home *** CD-ROM | disk | FTP | other *** search
/ Space & Astronomy / Space and Astronomy (October 1993).iso / pc / programs / space / jupit.exe / lha / JUPE.DOC < prev    next >
Text File  |  1991-03-30  |  11KB  |  364 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                                    J U P E
  13.  
  14.  
  15.  
  16.  
  17.                                  Version 2.0
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.                              Everything You Need
  27.                                 to Know About
  28.                               Observing Jupiter
  29.  
  30.  
  31.                                 DOCUMENTATION
  32.  
  33.  
  34.  
  35.  
  36.                                      by
  37.  
  38.  
  39.                                 Leonard Abbey
  40.  
  41.                                 CIS 72277,566
  42.  
  43.  
  44.  
  45.  
  46.  
  47.                                March 30, 1991
  48.  
  49.  
  50.                     Copyright (C) Leonard B. Abbey, 1991
  51.                              All Rights Reserved
  52.  
  53.  
  54.                           ABBEY INFORMATION SYSTEMS
  55.                              1002 Citadel Drive
  56.                            Atlanta, Georgia 30324
  57.  
  58.  
  59.         ABBEY INFORMATION SYSTEMS          JUPE                         2.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.                                 INTRODUCTION
  67.  
  68.  
  69.         JUPE is intended to provide information needed by the
  70.         observer of Jupiter.  It is specific for the MS-DOS computer
  71.         and requires an EGA or compatible VGA graphics adapter and
  72.         display.  
  73.  
  74.         JUPE came into existence to fill the needs which the author
  75.         had when he began observing Jupiter in 1951. This program
  76.         provides information in a form which is not available else-
  77.         where.  
  78.  
  79.  
  80.  
  81.                                FILES PROVIDED
  82.  
  83.  
  84.         The following files are to be found in the self-extracting
  85.         archive, JUPIT.EXE:
  86.  
  87.  
  88.                   READ.ME        A descriptive file.  
  89.                   JUPE.DOC       Documentation for JUPE.EXE
  90.                   JUPE.EXE       The program itself.  
  91.                   JUPE.SLB       A compressed screen library.  
  92.  
  93.  
  94.         The following is also required:
  95.  
  96.  
  97.                   JUPE.GXL       A graphics library.
  98.  
  99.  
  100.         It is supplied in two formats: JUPE-E.EXE for EGA monitors,
  101.         and JUPE-V.EXE for VGA monitors.  Either of these self-
  102.         extracting files will produce the file JUPE.GXL which con-
  103.         tains screens for the appropriate graphics card.  These files
  104.         are downloaded separately from CompuServe.
  105.  
  106.         If any of these files are missing, please contact the author.  
  107.  
  108.  
  109.  
  110.                         COPYRIGHT NOTICE AND LICENSE
  111.  
  112.  
  113.         JUPE is free.  However, it is not in the public domain.  This
  114.         program, and its accompanying documentation, are copyrighted
  115.         under the laws of the United States of America.  
  116.  
  117.  
  118.    ABBEY INFORMATION SYSTEMS          JUPE                              3.
  119.  
  120.  
  121.         You are licensed to use this program as follows:
  122.  
  123.              1.  You may use JUPE for personal, non-commercial
  124.                  purposes.  
  125.  
  126.              2.  You may copy and distribute JUPE for non-
  127.                  commercial purposes, provided you do not omit
  128.                  this documentation, or any of the other files
  129.                  provided in the JUPIT packages.  Credit must
  130.                  be given to the author.  
  131.  
  132.              3.  You may upload JUPE to bulletin boards pro-
  133.                  vided you do not omit this documentation, or
  134.                  any of the other files provided in the
  135.                  JUPIT.EXE packages.  Credit must be given to
  136.                  the author. 
  137.  
  138.              4.  You may not alter the program in any way or
  139.                  charge money for distributing it (other than
  140.                  minor charges for media).  
  141.  
  142.  
  143.  
  144.                                   WARRANTY
  145.  
  146.  
  147.         This program, and it's accompanying documentation, is without
  148.         warranty, express or implied.  This includes warranties of
  149.         merchantability or suitability for intended purpose.  It is
  150.         supplied "as is."  The author will not be held liable for any
  151.         consequental damages.  
  152.  
  153.  
  154.  
  155.                              SYSTEM REQUIREMENTS
  156.  
  157.  
  158.         JUPE.EXE is written for IBM-standard, MS-DOS computers.  It
  159.         requires a minimum of 256 K free Random Access Memory to load
  160.         and run.  MS-DOS version 3.x is recommended.  
  161.  
  162.         The program can be run from a floppy-disk drive or from a
  163.         hard disk.  
  164.  
  165.         JUPE.EXE requires an EGA, Super EGA, or VGA graphics adapter. 
  166.  
  167.  
  168.  
  169.    ABBEY INFORMATION SYSTEMS          JUPE                              4.  
  170.  
  171.  
  172.                             WHAT THE PROGRAM DOES
  173.  
  174.  
  175.         JUPE provides the following information:
  176.  
  177.  
  178.                       Nomenclature of the planet's
  179.                         prominent markings
  180.  
  181.                       Central Meridian
  182.  
  183.                       Satellite configuration
  184.  
  185.                       Miscellaneous physical data
  186.  
  187.  
  188.         The program is augmented by detailed help and definition
  189.         screens. 
  190.  
  191.  
  192.  
  193.                            INSTALLING THE PROGRAM
  194.  
  195.  
  196.         De-archiving the program.
  197.  
  198.         JUPE is supplied in twp self-extracting archives, JUPIT.EXE;
  199.         and either JUPE-E.EXE, or JUPE-V.EXE.  These archives were
  200.         produced with the LHARC program.  To extract the files,
  201.         merely type "JUPIT", "JUPE-E" or "JUPE-V" (without the quota-
  202.         tion marks).  No other software is required to perform the
  203.         extraction. 
  204.  
  205.  
  206.         Floppy Disk Installation.  
  207.  
  208.         Insert the floppy disk containing the extracted programs into
  209.         the disk drive. 
  210.  
  211.  
  212.         Hard Disk Installation.  
  213.  
  214.         Copy the extracted program files onto the hard disk.  The
  215.         SLB, EXE, and GLX files must be available to the program. 
  216.  
  217.  
  218.                                    WARNING
  219.  
  220.                  ONLY ONE OF THE GLX FILES SHOULD BE
  221.                  UNPACKED.  IF BOTH ARE PRESENT, THE PROGRAM
  222.                  WILL NOT RUN CORRECTLY.
  223.  
  224.  
  225.  
  226.    ABBEY INFORMATION SYSTEMS          JUPE                              5.  
  227.  
  228.  
  229.         Setup.  
  230.  
  231.         The program is able to determine its location on a hard disk.  
  232.         This allows it to determine where to search for the SLB and
  233.         GLX files.  This feature requires DOS version 3.0 or later.  
  234.         If your DOS version is earlier than this, the program will
  235.         function, but you will have to make the directory in which it
  236.         resides the default directory before the program is run. 
  237.  
  238.         Daylight Savings Time is NOT adjusted for by this program.  
  239.  
  240.  
  241.         Configuration File
  242.  
  243.         The program will read your time zone from a simple configu-
  244.         ration file.  You must create the file with a word processor,
  245.         and save it in ASCII format under the name "JUPE.CFG".  It
  246.         must be in the same subdirectory as the main program, and it
  247.         can only contain one number, between -12 and +12.
  248.  
  249.         For those few locations with half-hour time zones, the pro-
  250.         gram will round off any number in the CFG file to the nearest
  251.         half hour.
  252.  
  253.  
  254.  
  255.                                   OPERATION
  256.  
  257.  
  258.         Running the program. 
  259.  
  260.         If the directory (or disk) which contains the program is in
  261.         the PATH, type "JUPE" (without the quotation marks).  Other-
  262.         wise, move to the directory containing the program, and type
  263.         "JUPE". 
  264.  
  265.         The operation of the program is fully documented by help
  266.         screens.  These are available from any of the program screens
  267.         by pressing F1.  
  268.  
  269.         Definitions of Jupiter's various features are shown on the
  270.         definition screens, which are available by pressing F3. 
  271.  
  272.         In order to calculate the central meridian and satellite the
  273.         program asks for the date and time for which the predictions
  274.         are desired.  If these are not entered, the current date and
  275.         time are used.  It is therefore important that the system
  276.         clock be set before the program is run.  Wherever time is
  277.         to be entered, it should be in the 24-hour system.       
  278.  
  279.  
  280.    ABBEY INFORMATION SYSTEMS          JUPE                              6.
  281.  
  282.  
  283.         Command line switch.
  284.  
  285.         One command line switch has been provided.  This switch is a
  286.         number which represents your time zone.  If your location is
  287.         WEST of Greenwich, this number must be NEGATIVE. If Daylight
  288.         Savings Time is being observed at your location, ADD 1 to
  289.         this number. 
  290.  
  291.                                    *  *  *
  292.  
  293.                ALL LOCATIONS IN THE CONTINENTAL UNITED STATES
  294.                           HAVE NEGATIVE TIME ZONES
  295.  
  296.                                    *  *  *
  297.  
  298.         To use the command line switch, run the program as follows:
  299.  
  300.                                   JUPE /-7
  301.  
  302.         The "7" may be preceded by a "/", or a space (" ").  The
  303.         example configures the program for Mountain Standard Time.  
  304.         If Daylight Savings Time were in use, you would use the
  305.         following command line:
  306.  
  307.                                    JUPE /-6
  308.  
  309.  
  310.         If the time zone is entered through the command line switch,
  311.         any value read from a configuration file will be over-ridden.
  312.  
  313.  
  314.  
  315.                                    SUPPORT
  316.  
  317.  
  318.         In the unlikely event that support is required, the author
  319.         may be reached on CompuServe's ASTROFORUM, or at the follow-
  320.         ing address:
  321.  
  322.  
  323.                              Leonard B. Abbey
  324.                              1002 Citadel Drive
  325.                              Atlanta, Georgia  30324
  326.  
  327.                              404-633-7446
  328.  
  329.                              CIS # 72277,566
  330.  
  331.  
  332.         Comments and suggestions are welcome.
  333.  
  334.  
  335.  
  336.    ABBEY INFORMATION SYSTEMS          JUPE                              7.  
  337.  
  338.  
  339.  
  340.                                    CREDITS
  341.  
  342.  
  343.         JUPE.EXE was written in Microsoft's BASIC Professional Devel-
  344.         opment System, Version 7.1 It employs extensive assembly
  345.         language subroutines from MicroHelp's Mach 2 and QB/Pro
  346.         libraries. The graphics screens were produced with ZSoft's PC
  347.         Paintbrush IV.  
  348.  
  349.         The routines for displaying PCX screens are from Genus' PCX
  350.         Programmer's Toolkit.                                         
  351.  
  352.  
  353.                                    HISTORY
  354.  
  355.  
  356.         Version 1.0  January 15, 1990  -  Original release. 
  357.         Version 1.1  January 21, 1990  -  Corrected error in date
  358.                                           when passing midnight.
  359.         Version 2.0  March 30, 1991    -  Improved graphics and
  360.                                           EGA support.
  361.  
  362.  
  363.  
  364.